home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / FREENET / AEBY / SMAIL-AL / README < prev   
Text File  |  1995-05-29  |  4KB  |  131 lines
  1. This is an early alpha release of smail. Please don't expect it
  2. to be easy to install nor to work reliably.
  3.  
  4. 1. Installing
  5.  
  6.   1. Copy the usr directory to $.usr
  7.   
  8.   2. Edit $.usr.smail.lib.config (various things) and
  9.      $.usr.smail.lib.routers (change path of the smarthost
  10.      driver to the FQDN of your mail server)
  11.      
  12.   3. edit etc.passwd (replace user1 by the name of you)
  13.      you can add new users by using !NewsBase's menus
  14.   
  15.   4. add the "Newsbase.smtp" directory to !NewsBase transports
  16.      (Not tested but should work)
  17.      
  18.   5. run !boot
  19.   
  20.   6. you can now run !run (or do something different - I suggest
  21.      you have a look at the !boot file to see what functions
  22.      smail provide - I just say "aliases")
  23.      
  24.  
  25. 2. Installing if you have already got uucp/smail installed
  26.  
  27.   1. replace !uucp.bin.smail by bin.smail
  28.   
  29.   2. add the host, addr out of usr.smail.lib.routers entries to
  30.      /usr/smail/lib/routers (either $.usr.smail.routers or
  31.      !uucp.usr.smail.routers), replace the smarthost entry
  32.      
  33.   3. add the smtp entry to /usr/smail/lib/transports
  34.   
  35.   4. copy the "set alias..." commands out of the !boot file
  36.      into !uucp.!boot (don't forget to run !boot after).
  37.      
  38.   ... should be all ...
  39.      
  40.   5. re-run !uucp_conf if you want to remove SMTP support
  41.  
  42.  
  43. 3. Functionality:
  44.  
  45. !run: runs smail in daemon mode (-bd) as a wimp task (-oW), listen
  46.       to the smtp port for incoming connections and run through
  47.       the spooled mail queue every 5 minutes (-q5m)
  48.       
  49.       Whenever an incoming connection is detected in_smtpd is run
  50.       on the specific port (yep, another wimp task using about 448k)
  51.       
  52.       When the queue re-run time is reached runq is run (yet another
  53.       wimp task using about 1Meg!)
  54.       
  55.       Memory requirements: 320k + 1Meq when running through the queue
  56.                          + 448k for every open incoming connection
  57.                          
  58. smtpd: read smtp commands from the keyboard (stdin resp.) and output
  59.        responses to the screen (stdout resp.)
  60.        
  61. runq: start up a wimp task running through the mail queue and trying
  62.       to send the spooled messages
  63.       
  64. rsmtp: run batchsmtp mode - take smtp commands from stdin
  65.  
  66. in_smtpd: run a smtpd daemon for an incoming connection. This command
  67.       is executed by "!run" for every incoming connection. Please don't
  68.       run this command manually.
  69.       Received messages will only be stored in the mail queue rather
  70.       than being directly delivered. This is preferable if you run
  71.       an "expensive" connection to the outer world (e.g. SLIP over
  72.       modem) as this will be much faster than delivering immediately.
  73.       Messages will be delivered on the next runq run.
  74.       
  75. mailq: list the messages queued for delivery
  76.  
  77. rmail: read a message from stdin and deliver to the addresses given
  78.        on the command line (e.g. "rmail test@anywhere.com")
  79.        
  80.        
  81.  
  82. 4. Known Bugs
  83.  
  84. Many of them ... a selection:
  85.  
  86.    1. no DNS support ("bind" router driver)
  87.    2. sometimes crashes when memory is low
  88.    3. when smail daemon runs with -qXy quitting the respective
  89.       wimp task (use "quit" in the Task display) results in
  90.       runqs forking off wildly (well, it stops as soon as there's
  91.       no memory left :-))
  92.    4. smail has mostly been tested with ACORN's TCP/IP suite -
  93.       I don't know if it'll work with freenet correctly.
  94.       
  95. Send bug reports to aeby@graeff.com, please!
  96.  
  97.  
  98.  
  99. 5. Further documentation
  100.  
  101. Get the UUCP documentation from hensa (the man pages are too large
  102. to include them here). It includes the smail documentation.
  103.  
  104. To add:
  105.    There are some RISC OS specific options:
  106.   
  107.       -oW[name]        (e.g. smail -bd -oWsmail_daemon)
  108.                   run smail as a wimp task (if possible - if 
  109.                   wimp_init fails fall back into CLI command mode).
  110.                   Use name (optional) as the name appearing in
  111.                   the Task display.
  112.                   The wimp task can only be quit in the
  113.                   Task display (or if the program quits by itself)
  114.                   
  115.       -ssocketnumber    (e.g. smail -bd -s10)
  116.                   This option does only make sense together with the
  117.                   -bd option and does then mean:
  118.                   Run smail in daemon mode serving one open connection
  119.                   on the open socket "socketnumber". This option is
  120.                   used by in_smtpd
  121.                   
  122.                   
  123. Thomas Aeby,
  124. 29.5.95
  125.  
  126. Send comments to aeby@graeff.com, please
  127.  
  128.       
  129.   
  130.   
  131.